package com.hzy.nursing.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.hzy.nursing.domain.Reservation;
import com.hzy.nursing.vo.TimeCountVo;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 预约信息Mapper接口
 *
 * @author HZY
 * @date 2025-10-11
 */
@Mapper
public interface ReservationMapper extends BaseMapper<Reservation> {

    /**
     * 根据动态条件查询预约信息列表
     * (此方法用于支持若依框架的动态SQL查询)
     *
     * @param reservation 包含查询条件的预约信息对象
     * @return 预约信息集合
     */
    List<Reservation> selectReservationList(Reservation reservation);

    /**
     * 根据时间范围统计每个时间点的预约数量
     *
     * @param startOfDay 查询开始时间 (例如：今天 00:00:00)
     * @param endOfDay   查询结束时间 (例如：明天 00:00:00)
     * @return 统计结果列表
     */
    List<TimeCountVo> countReservationsForTime(@Param("startOfDay") LocalDateTime startOfDay, @Param("endOfDay") LocalDateTime endOfDay);

    /**
     * 查询指定用户在某时间范围内的已取消预约数量
     * (用于支持Controller中的业务：判断用户当天取消次数是否超限)
     *
     * @param createBy   创建者ID (即用户ID)
     * @param startOfDay 查询开始时间
     * @param endOfDay   查询结束时间
     * @return 已取消的预约数量
     */
    Integer countCancelledReservations(@Param("createBy") String createBy, @Param("startOfDay") LocalDateTime startOfDay, @Param("endOfDay") LocalDateTime endOfDay);

}